<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Server Configuration Reference - Connectors Overview</title><meta name="author" value="Ian Darwin"><meta name="email" value="ian779@darwinsys.com"><meta name="author" value="Jean-Frederic Clere"><meta name="email" value="jfrederic.clere@fujitsu-siemens.com"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="0"><!--PAGE HEADER--><tr><td><!--PROJECT LOGO--><a href="http://jakarta.apache.org/tomcat/"><img src="../../images/tomcat.gif" align="right" alt="
    The Tomcat Servlet/JSP Container
  " border="0"></a></td><td><font face="arial,helvetica,sanserif"><h1>Apache Tomcat 4</h1></font></td><td><!--APACHE LOGO--><a href="http://www.apache.org/"><img src="../../images/asf-logo.gif" align="right" alt="Apache Logo" border="0"></a></td></tr></table><table border="0" width="100%" cellspacing="4"><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top" nowrap="true"><h1>Connectors Overview</h1></td><td align="right" valign="top" nowrap="true"><img src="../../images/void.gif" width="1" height="1" vspace="0" hspace="0" border="0"></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote>
<p>
There are two different types of connectors. Connectors that allow browsers to
connect directly to the Tomcat and connectors that do it through a Web Server.
</p>
<p>
The connectors allowing direct connections are distributed as jar files with
the Tomcat binary releases.
</p>
<p>
The connectors used with a Web Server are made of 2 components. One written
in Java and the other written in C. The Java part is included, as a jar file
,

with the Tomcat binary releases. The C part is released separately and may be
obtained from the
<a href="http://tomcat.apache.org/download-connectors.cgi">
Tomcat Connectors Downloads</a>.
</p>
<p>
The total number of different operating systems and web servers is sufficiently
large that it is not practical to provide binaries downloads for every
combination. Binaries are provided for most of the popular combinations and if
the one you need is not available do not hesitate to ask for it on the
tomcat-user mailing list but please be patient and accept you may have to build
it yourself with the help of the mailing list.
</p>
<p>
The source code for the Tomcat Connectors is available from the SVN repository
(<a href="http://tomcat.apache.org/svn.html">Tomcat SVN structure</a>) or as a
bundle (that includes both the Java and the C components) from the
<a href="http://tomcat.apache.org/download-connectors.cgi">
Tomcat Connectors Downloads</a>.


</p>

</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Tomcat connectors"><strong>Tomcat connectors</strong></a></font></td></tr><tr><td><blockquote>
<p>
The following table lists most of the existing Tomcat connectors.
</p>

<table border="1">
<tr><th colspan="4">HTTP Connectors for Tomcat 4.x</th></tr>
<tr><th>Client</th><th>Protocol</th><th>Tomcat className</th><th>Notes</th></tr>

<tr><td>Modern browser</td><td>HTTP/1.1</td>
	<td>org.apache.coyote.tomcat4.CoyoteConnector</td>
	<td>Current practice<br>See <a href="coyote.html"> Coyote HTTP/1.1</a>
        </td>
</tr>

<tr><td>Modern browser</td><td>HTTP/1.1</td>
	<td>org.apache.catalina.connector.http.HttpConnector</td>
	<td>Deprecated<br>See <a href="http11.html"> HTTP/1.1</a></td>
</tr>

<tr><td>Ancient browser</td><td>HTTP/1.0</td>
	<td>org.apache.catalina.connector.http10.HttpConnector</td>
	<td>Deprecated<br>See <a href="http11.html"> HTTP/1.1</a></td>
</tr>


<tr><th colspan="4">Web Server Connectors</th></tr>

<tr><th>Web Server Side</th><th>Protocol</th><th>Tomcat Side</th><th>Notes</th></tr>

<tr>
	<td>JK</td><td>AJP/1.3</td>
	<td>CoyoteConnector with JkCoyoteHandler</td>
	<td>Current<br>mod_jk supports load balancing.
        Enabled by default in 4.1; works in 4.0. See <a href="jk.html">JK</a>
        and <a href="coyotejk.html">Coyote JK</a>.
        </td>
</tr>

<tr>
	<td>mod_proxy with AJP enabled</td><td>AJP/1.3</td>
	<td>CoyoteConnector with JkCoyoteHandler</td>
	<td>Current<br>Available for Apache httpd 2.x and included by default with
        2.2. See <a href="http://httpd.apache.org/docs-2.1/mod/mod_proxy_ajp.html">
        mod_proxy_ajp</a> and <a href="coyotejk.html">Coyote JK</a>
        </td>
</tr>

<tr>
	<td>mod_jserv</td><td>AJP/1.2</td>
	<td>Ajp11</td>
	<td>Obsolete<br>Read more at 
        <a href="http://java.apache.org/jserv/index.html"> JServ</a></td>
</tr>

<tr>
	<td>JK2</td><td>AJP/1.3</td>
	<td>CoyoteConnector with JkCoyoteHandler</td>
	<td>Deprecated<br>Enabled by default in 4.1.
	mod_jk2 supports in-process JVM and load balancing.
        See <a href="jk2.html">JK2</a>
        </td>
</tr>

<tr>
	<td>JK or JK2</td><td>AJP/1.3</td>
	<td>org.apache.ajp.tomcat4.Ajp13Connector</td>
	<td>Deprecated<br>
        See <a href="ajp13.html">AJP/1.3</a>
        </td>
</tr>

<tr>
	<td>mod_webapp</td><td>WARP/1.0</td>
	<td>WarpConnector</td>
	<td>Deprecated<br>Not for Win32; no in-process nor load balancing; 
        works in 4.x.
        Uses <a href="http://apr.apache.org/">APR</a>.
        Supported Apache-2.0 and Apache-1.3).
        See <a href="webapp.html">Webapp</a>
        </td>
</tr>
</table>
</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Why a Tomcat connector with a native Web Server?"><strong>Why a Tomcat connector with a native Web Server?</strong></a></font></td></tr><tr><td><blockquote>
<p>
A Web Server can host different applications written using PERL, PHP, C or 
any other language. If one application is written in Java using the Servlet 
API a connector is need to route the requests from the Web Server to the
Servlet Engine. In the case a Web Server specific connector is needed.
Most of the Web Servers allow to load dynamic extentions (DLL). Some of these
extentions are available in the binary builds of connectors.
</p>

</blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em>
        Copyright &copy; 1999-2009, Apache Software Foundation
        </em></font></div></td></tr></table></body></html>